home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / packer / uuencdec / readme next >
Encoding:
Text File  |  1991-05-31  |  2.6 KB  |  74 lines
  1.  
  2. README file for UUCODER version 1.0
  3.  
  4. * What is UUCODER?
  5.  
  6. UUCODER is a GEM-based, mouse-driven program that encodes
  7. and decodes files. It supports the uuencode format commonly used on
  8. Usenet.
  9.  
  10. * What's the point of encoding files?
  11.  
  12. Usenet and many electronic-mail systems do not provide for the
  13. transfer of binary files such as programs, resource files, archives
  14. and other non-text material.
  15.  
  16. Uuencoding is a way of getting around this restriction by translating
  17. 8-bit binary data into 7-bit printable text. This process expands the
  18. size of the file by a ratio of 4 to 3. The reverse process,
  19. uudecoding, transforms the text back into binary data.
  20.  
  21. * Where does this program come from?
  22.  
  23. The encoding and decoding routines originated as the public-domain
  24. Dumas UUE and UUD programs, which are enhanced but compatible with
  25. standard Un*x uuencode. The Dumas enhancements include a translation
  26. table that can help repair files damaged by brain-dead
  27. EBCDIC<-->ASCII gateways and the ability to ``chain'' a long binary
  28. file into multiple takes that can be automatically recombined.
  29.  
  30. I reworked the Dumas code somewhat to allow it to handle some of the
  31. more bizarre filenames I've found embedded in uuencoded data.
  32.  
  33. * How do I use UUCODER?
  34.  
  35. UUCODER is GEM-based and operation should be self-explanatory. Just
  36. run it and click on the appropriate menu selection.
  37.  
  38. UUCODER automatically combines binaries that were split into multiple
  39. ``takes'' by Dumas UUE. The takes must be in the current directory,
  40. or they may be concatenated. UUCODER will untangle illegal filenames
  41. created by some encoders, such as ``filename.z.uab'' or 
  42. ``filename.arc.uab''.
  43.  
  44. UUCODER allows you to split long files into multiple takes when
  45. encoding, too. There is a menu selection for choosing the maximum
  46. output file length. The default is 32K uuencoded lines of 62 bytes
  47. each.
  48.  
  49. * Is source code for this available?
  50.  
  51. Yes. It should be available from the Usenet comp.sources.atari.st
  52. archives (archive-server@twitterpater.Eng.Sun.COM), the University of
  53. Michigan's Atari software files (atari@atari.archive.umich.edu), on
  54. GEnie, or as a last resort by asking me to mail it to you. My address
  55. is below.
  56.  
  57. * What should you do if you like or dislike this program?
  58.  
  59. Let me know! This is just a ``first pass'' at the program; future
  60. versions may be enhanced.
  61.  
  62. Send bug reports and/or suggestions for enhancement, or just a
  63. picture postcard, to:
  64.  
  65. Steve Yelvington
  66. Box 38
  67. Marine on St. Croix, MN 55047 USA
  68.  
  69. Internet: steve@thelake.mn.org
  70. UUCP: plains!umn-cs!thelake!steve
  71. Citadel: mast!moundst!thelake!steve
  72. GEnie: S.YELVINGTO2
  73.  
  74.